home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Taifun / Taifun 026 (1987-08-15)(Ossowski, Stefan)(DE)(PD).zip / Taifun 026 (1987-08-15)(Ossowski, Stefan)(DE)(PD).adf / HandShake / Handshake.doc < prev    next >
Text File  |  2014-07-25  |  15KB  |  345 lines
  1. HandShake V1.20a Summary of Features.
  2.  
  3. If you want to see how this version of Handshake has changed from the
  4. previous versions please refer to the Version History section at the end
  5. of this document.
  6.  
  7. WHAT IS IT?
  8.  
  9. Handshake is a Full featured VT52/100/102 terminal emulator for those
  10. people who really need it. I have taken great pains to support the full
  11. VT102 spec. (VT102 is a superset of VT100).
  12.  
  13. Feel free to use and distribute this program as you like, as long as it is
  14. not for commercial use. If you like it, use it and want to see it get
  15. better, please send a contribution of $25.00 to the address listed in the
  16. program's "About.." requester. Commercial users are urged to contact the
  17. author.
  18.  
  19. WHAT IS IT NOT?
  20.  
  21. Handshake doesn't try to be an all round, general purpose, modem program
  22. which supports a multitude of transfer protocols, a script language, etc.
  23. There are plenty of good programs out there which fulfill this need.
  24.  
  25. WHAT IS THIS DOCUMENT?
  26.  
  27. This document is a quick description of the features of Handshake paying
  28. particular attention to the less obvious aspects of Handshake so that an
  29. experienced user will be able to use the program. This document assumes
  30. that the user has experience with terminal programs and the Amiga.
  31. Especially the Intuition user interface ( Menus, requesters, etc. )
  32.  
  33. WHAT IS THIS DOCUMENT NOT?
  34.  
  35. This is not full Handshake documentation!! That will be coming at a later
  36. date. If you are not familiar with terminal programs or the Amiga user
  37. interface, find a friend who is and ask him/her to help you.
  38.  
  39. WHAT DO YOU NEED TO RUN HANDSHAKE?
  40.  
  41. An Amiga with 256K or more. Version 1.2 of Kickstart and Workbench.
  42. THIS PROGRAM WILL NOT WORK WITH VERSION 1.1 OR EARLIER OF AMIGADOS.
  43. Hardware to connect to the other computer. This may consist of only a cable
  44. if you are locally wired, or a cable and a modem if you are accessing the
  45. other computer over the telephone.
  46.  
  47. WHY SHOULD YOU USE HANDSHAKE?
  48.  
  49. If you have a requirement for FULL VT100/102 compatability and have not
  50. been satisfied by other programs which only do half the job, this is
  51. probably the program you have been looking for!
  52.  
  53. Here is a list of some of the features that Handshake offers:
  54.  
  55.     - Full 24 line display with title bar enabled! No more turning the
  56.       title bar on and off to see all 24 lines.
  57.  
  58.     - Full VT52 support. Every VT100 has a VT52 inside of it. So does
  59.       Handshake -- right down to the VT52 graphics character set.
  60.  
  61.     - VT102 Edit mode. Local insert and deletes.
  62.  
  63.     - Smooth or Jump scrolling.
  64.  
  65.     - Block or Underline see through reverse video cursor.
  66.  
  67.     - Full VT100 Special Graphics Character Set.
  68.  
  69.     - Full double height and double width characters.
  70.  
  71.     - 132 character per line mode.
  72.  
  73.     - Double height and width characters in 132 column mode.
  74.  
  75.     - All character modes. Normal, Bold, Reverse video, Underline and
  76.       Blinking in any combination.
  77.  
  78.     - Full keyboard support. This includes VT52 mode. Handshake handles the
  79.       escape sequences to turn auto repeat on and off and lock the
  80.       keyboard. No more run away cursors while in EDT under VMS etc.
  81.  
  82.     - ASCII file transfer mode with user definable end-of-line translation
  83.       for both sending and receiving. No more carriage returns in your
  84.       received files.
  85.  
  86.     - XMODEM file transfer for binary files.
  87.  
  88.     - Dialing Support with a 20 Phone number Directory. Optional auto
  89.       redialing is available. System characteristics ( baud rate, data
  90.       bits, parity, stop bits ) can be specified in the dialing directory
  91.       entry. Auto redial can be specified in the directory entry. This
  92.       dialing mode is geared to Hayes compatible modems, although the user
  93.       can specify the dialing prefix ( ATDP or ATE0DT, etc. ).
  94.  
  95.     - Fast! Using a 95K text file captured from a VAX which was then sent
  96.       to Handshake from a local microcomputer, Handshake maintained a
  97.       throughput of 875 characters per second. This means that Handshake
  98.       can take characters as fast as your host can send them at 7200 baud,
  99.       and still look good at 9600. A real VT100 can't keep up at 9600
  100.       baud either.
  101.       
  102.     - Complete Workbench integration. Handshake can be started from the
  103.       Workbench. As you save parameter files icons are created. These icons
  104.       can be used to invoke Handshake later with the same paremeters. You
  105.       can even specify a host to dial immediately when the icon is invoked.
  106.  
  107. WHAT DO YOU NEED TO KNOW ABOUT HANDSHAKE TO USE IT NOW?
  108.  
  109. The follwing things about Handshake are not obvious so you should
  110. familiarize yourself with this section.
  111.  
  112. Command line.
  113.  
  114.     Handshake can be invoked from the CLI. The general form of the command
  115.     line is illustrated below (parts in square brackets are optional):
  116.  
  117.     Handshake [-p parameter_file_name] [destination_name]
  118.  
  119.     The parameter file name is the parameter file to be used, if none is
  120.     specified the default file Handshake.parms is used.
  121.  
  122.     The destination name is the name of the remote computer to be dialed.
  123.     This name must be one that appears in dialing directory of the
  124.     parameter file being used and must be spelled exactly the same way it
  125.     is spelled in the dialing directory entry (Case of characters is not
  126.     significant).
  127.  
  128.     If the name in the dialing diretory entry ends in a '*' or the Auto
  129.     Redial menu selection is set in the parameter file, Handshake will keep
  130.     dialing the number until a connection is made. If the name in the
  131.     dialing directory entry ends in a '*', do not include the '*' on the
  132.     command line when specifying the destination name.
  133.  
  134.     If this dialing directory entry appeared in the default file
  135.     Handshake.parms:
  136.  
  137.     555-1234:1200,8,n,1 Fred's BBS*
  138.  
  139.     The following command line coule be used to call this BBS.
  140.  
  141.     Handshake "Fred's BBS"
  142.  
  143.     Note that the '"'s are necessary in this case because the name of the
  144.     BBS has a space in it.
  145.  
  146.     Here is another example.
  147.  
  148.     Handshake -p universities.parms UCLA
  149.  
  150.     This would dial the phone number associated with the descriptor UCLA
  151.     in the parameter file universities.parms
  152.  
  153.     For a complete description of dialing directory entries, see the
  154.     discussion later in this section
  155.  
  156. Workbench.
  157.  
  158.    Handshake can also be invoked from the Workbench. There is an icon which
  159.    looks like a terminal. Invoking this icon will cause Handshake to be
  160.    invoked with the parameters from Handshake.parms, or if this file does
  161.    not exist Handshake will use it's built in parameters.
  162.    
  163.    In the project menu there is an item "Create Icons". if you set this to
  164.    "Yes" Handshake will create a telephone icon every time that you save
  165.    the parameters. While Handshake is saving the parameters it will also
  166.    prompt you for a dialing descriptor which if specified will be used as
  167.    the initial dialing destination when the icon is invoked.
  168.    
  169.    CLI users will probably want to keep the "Create Icons" option set to
  170.    "No" so that their disks will not be cluttered with un-necessary .info
  171.    files.
  172.  
  173. Keyboard.
  174.  
  175.     VT100 Keys                Amiga Keys
  176.     ----------                ----------
  177.     Arrow keys                Arrow keys
  178.     F1 through F4             F1 through F4
  179.     Keypad 0 through 9        Keypad 0 through 9
  180.     Keypad .                  Keypad .
  181.     Keypad -                  Keypad -
  182.     Keypad ,                  Help key              ** Watch for this **
  183.     Keypad Enter              Keypad Enter
  184.  
  185.     The Back space and Del keys can be reversed with a menu option.
  186.  
  187. File Transfers.
  188.  
  189.     The "Receive/Transmit CR/LF as ..." menu options are only applicable to
  190.     the ASCII file transfer modes. These can be used to translate end of
  191.     line characters when sending to the other system. For instance, when
  192.     sending to a VAX which is receiving with the CREATE command, you
  193.     will want to send a carriage return to the  VAX at the end of each
  194.     line. Amiga text files have no carriage returns in them so lines are
  195.     terminated with line feed characters. By selecting the Transmit LF as
  196.     CR option Handshake will do the conversion for you.
  197.  
  198.     If you use the XMODEM binary file transfer mode, be aware that the
  199.     received file will probably have to be truncated. This is because all
  200.     files received by XMODEM are a multiple of 128 bytes long. AmigaDos
  201.     does not like these extra bytes. There are several good public domain
  202.     utilities available to strip these bytes off the end of the file
  203.     (TAILRID, for one). If you send your files in ARC format then this is
  204.     not a problem.
  205.  
  206. Dialing the Phone.
  207.  
  208.     In order to dial a number from the dialing directory ( Menu option 
  209.     "Dial Phone" ), click using the mouse on the small square gadget
  210.     immediately to the left of the number that you want to dial. Clicking
  211.     on the text of the number allows you to edit the entry, but not to
  212.     dial it.
  213.  
  214.     The dialing directory is saved to disk whenever you save the parameters
  215.     It is possible to have several diailing directories by using different
  216.     parameter files.
  217.  
  218. Format of dialing directory entries.
  219.  
  220.     A dialing directory entry has the following general format. The parts
  221.     in the square brackets are optional. The * at the end of the line is
  222.     used to indicate auto redialing.
  223.  
  224.     telephone_number[:baudrate[,data_bits[,parity[,stop_bits]]]] [desc][*]
  225.  
  226.     Below are some sample dialing directory entries:
  227.  
  228.     123-4567                                      Simplest case. Dial the
  229.                                                   number using the current
  230.                                                   serial parameters.
  231.  
  232.     123-4567 Joe's BBS                            Same as above with a
  233.                                                   description.
  234.  
  235.     123-4567 *                                    Both of these will dial
  236.     123-4567 Joe's BBS*                           Until the other system
  237.                                                   Answers.
  238.  
  239.     123-4567:1200                                 Call the number changing
  240.                                                   baud rate to 1200 if
  241.                                                   necessary.
  242.  
  243.     123-4567:1200,8,n,1 Joe's BBS*                A biggie. Call Joe's
  244.                                                   until it answers using
  245.                                                   1200 baud, 8 data bits,
  246.                                                   no parity and 1 stop
  247.                                                   bit.
  248.  
  249. Interlace.
  250.  
  251.     The Half screen interlace mode is intended to give you a full 24 line
  252.     VT100 Emulation in half a screen. This leaves you the other half to do
  253.     whatever you like, and still watch your terminal screen.
  254.  
  255.     The full screen interlace mode is useful in 132 column mode.
  256.     Readability of characters in interlaced mode may depend on your
  257.     selection of colors. (I find that black characters on a gray
  258.     background look just super ).
  259.  
  260.  
  261. WHAT PROBLEMS ARE THERE WITH HANDSHAKE?
  262.  
  263. Nothing that I currently Know of. However you may find that you can not see
  264. the last two or three columns of 132 column mode. If this happens to you,
  265. run Preferences and move the screen centering gadget to the left a bit.
  266. This should fix the problem.
  267.  
  268. WHO DO YOU CALL WITH PROBLEMS, SUGGESTIONS ETC?
  269.  
  270. Me!
  271.     Eric Haberfellner,
  272.     57 Marble Arch Crescent
  273.     Scarborough, Ontario
  274.     CANADA
  275.     M1R 1W8
  276.  
  277.     Phone (416) 757-1055 ( After Six P.M. please ).
  278.  
  279.     I am on BIX as ehaberfellner.
  280.  
  281.  
  282. HANDSHAKE VERSION HISTORY
  283.  
  284. Version 1.20a
  285.  
  286.     - Improved Workbench interface. Handshake will now optionally create
  287.       create Telephone icons for saved parameter files. This allows the
  288.       user to select which paramter file to use from the Workbench. The
  289.       icons can also be created in such a way that Handshake will
  290.       automatically start dialing a specified number when it is invoked
  291.       with that icon.
  292.     - Fixed a bug which caused XMODEM transmits to sometimes hang.
  293.     - Changed autodialing support so that it now works with modems that
  294.       report status while they are dialing (Like the Volksmodem 1200).
  295.     - Dialing destinations which contained spaces on the command line did
  296.       not work, even when enclosed in quotes. This has been fixed.
  297.     - Selecting the Reset Terminal option from the menu or typing Amiga-V
  298.       would cause two cursors to appear on the screen. This has been fixed.
  299.  
  300. Version 1.10a
  301.  
  302.     - At last, a real 132 columns instead of 128.
  303.     - Added some intelligence to the routines that display the cursor. This
  304.       yielded a 35% performance improvement. Handshake now has an average
  305.       throughput of about 875 characters per second.
  306.     - Cleaned up parsing of command line parameters especially the dialing
  307.       directory entry.
  308.     - Put error checking into reading of parameter files. If the file does
  309.       not exist or is of the wrong size put up a requester advising the
  310.       user. If the default file Handshake.parms cannot be found do not
  311.       annoy the user with a requester (use the built in defaults).
  312.     - The command line dialing direcotry entry is now case insensitive.
  313.     - Added some register variables in several places. Handshake is now
  314.       about six percent faster because of this.
  315.     - Fixed a bug which caused the line attribute for the bottom line to
  316.       not be reset when the screen was cleared.
  317.     - Fixed a hideous bug which caused the input subtask to lock up
  318.       sometimes. This would appear to the user as a blank title bar. This
  319.       would only happen if the user interface task sent a "go to sleep"
  320.       message to the serial input task at the same instant that an IO
  321.       completed, therefore this was more likely to happen at higher baud
  322.       rates. Sorry about that one.
  323. Version 1.02a ( not released to the public at large ).
  324.     - Added command line parameters to specify parameter file to use, and
  325.       to allow the user to specify a remote computer to dial from the
  326.       command line.
  327.     - Added 20 second dialing timeout to the dial timeout menu.
  328.     - In order to abort redialing it was sometimes necessary to select the
  329.       abort requester more than once. This is now fixed.
  330.     - Moved File transfer and redialing abort requester to upper right
  331.       portion of screen.
  332.     - General cleanup of the file transfer code. Receiveing to disk is now
  333.       much faster. Transfer aborts now work porperly at high baud rates.
  334.  
  335. Version 1.01a
  336.     - Auto redialing added.
  337.     - Pulse/Dial menu option replaced with user definable dialing string.
  338.     - Added menu item to allow user to specify backspace & del key
  339.       operation.
  340.     - Fixed bug which caused menus to not be updated after a reset if
  341.       no parameter file was present.
  342.  
  343. Version 1.00a
  344.     - Handshake Unleashed on an unsuspecting public. An historic Moment!
  345.